home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / bbs / masnddos.zip / MAILSEND.TXT < prev    next >
Text File  |  1997-01-03  |  15KB  |  420 lines
  1.  
  2.             DataEnter, Michael Kocum
  3.             Taborstrasse 27/23
  4.             A-1020 Vienna
  5.             AUSTRIA
  6.  
  7.         CIS: 70143,1667
  8.         MHS: MICHAEL @ DEMK (via CSERVE)
  9.    Internet: michael@demk.co.at
  10.         Fax: +43/1/214 38 29
  11.  
  12.  
  13.  
  14.  
  15.  
  16. Introduction to MailSend
  17. ------------------------
  18.  
  19. MailSend is a add-on for Microsoft Mail and Windows for Workgroups.
  20. MailSend sends messages from the command line or from batch files.
  21.  
  22.  
  23. Some suggestion as to what you can do:
  24.  
  25. -After you do your overnight backup, send the backup log to your mailbox
  26.  
  27. -Send your monthly report to your boss
  28.  
  29. -In a more sophisticated enviroment, you can export data out of your
  30.  application, pass it to MailSend as an attachment. MailSend will send
  31.  it to the destination and there you can use MailExtr to convert it back
  32.  to a file and import it in your application. In fact, a lot of
  33.  customers make their database updates via MailSend and MailExtr.
  34.  
  35.  
  36.  
  37. System Requirements
  38. -------------------
  39.  
  40.   DOS   version :  DOS 3.3
  41.   Win16 version :  Windows 3.1
  42.   Win32 version :  Windows NT 3.1 or Windows 95
  43.   OS/2  version :  OS/2 2.x
  44.  
  45.   Microsoft Mail, version 3.2 or
  46.   Windows for Workgroups or
  47.   Microsoft Exchange 4.0 or
  48.   MAPI.DLL ( optional in Win16 version ) or
  49.   MAPI32.DLL ( optional in Win32 version )
  50.  
  51.  
  52. Installation
  53. ------------
  54.  
  55.   - Create a directory of your choice copy MAILSEND.EXE into this
  56.     directory.
  57.  
  58.   - Use your editor to create a MAILSEND.DEF file for your common used
  59.     arguments (see section "Using MAILSEND.DEF").
  60.  
  61.  
  62. Arguments
  63. ---------
  64.  
  65. MailSend uses the following arguments:
  66.  
  67.  
  68. -mt                  Use MAPI as transport service
  69.                      ( Win16 and Win32 version only )
  70.  
  71.  
  72. -f<Mailbox>          Mailbox name
  73.                      or transport service name of you use the Exchange
  74.                      Client and MAPI (-mt)
  75.  
  76.                      Note: Argument is not necessary if you use MAPI (-mt).
  77.  
  78.  
  79. -p<Password>         Mailbox password (default is no password)
  80.  
  81.                      Note: Argument is not necessary if you use MAPI (-mt).
  82.  
  83.  
  84. -t<Dest>             Destination address in full Microsoft format
  85.                      or in the format your gateway requires it.
  86.                      Multiple addresses are allowed.
  87.  
  88.                      Format for MSMail 3.x is:
  89.                      Network/Postoffice/User
  90.  
  91.                      Format for Exchange is:
  92.                      EX:/o=Org/ou=ORGUNIT/cn=Recipients/cn=Mailbox
  93.  
  94.  
  95.                      Note: When using MAPI (-mt) on a Windows NT
  96.                            machine running MSMail for NT, the user part
  97.                            of the address is case sensitive.
  98.  
  99.                      If you are sending a message to a user on you own
  100.                      postoffice, you can use a simpler addressing format
  101.                      and let MailSend resolve the address. You will find
  102.                      more information about resolving addresses in the
  103.                      section "Resolving address" below.
  104.  
  105.                      You can send to multiply addresses by using more
  106.                      than one -t switch.
  107.  
  108.                      Note: Resolving an address is not available if you
  109.                            use MAPI (-mt)
  110.  
  111.  
  112. -c<Dest>             Carbon Copy ( CC ) destination address in full
  113.                      Microsoft format (Network/Postoffice/User) or in
  114.                      the format your gateway requires it.
  115.  
  116.  
  117. -s<Subject>          Subject for message
  118.  
  119.  
  120. -d<Drive>            Drive where MailData is located (default drive M)
  121.                      or full path to MailData.
  122.  
  123.                      Note: Argument is not necessary if you use MAPI (-mt).
  124.  
  125.                      If MailSend does not find a postoffice on the given
  126.                      drive, it will scan all your drives from C: to Z:
  127.                      for a postoffice and uses the first one it finds.
  128.  
  129.                      If there is still no postoffice found, it will try
  130.                      to find your MSMAIL.INI and read the postoffice
  131.                      drive from it.
  132.  
  133.                      In the unlikly event that MailSend can't find the
  134.                      postoffice in this way, it will give you an error.
  135.  
  136.                      You can start MailSend with the -l option and
  137.                      it will help you finding the postoffice.
  138.  
  139.  
  140. -i<ImportFile>       File to import for message bod. If the file size is
  141.                      more than 32KB it will be converted to an
  142.                      attachment.
  143.  
  144.  
  145. -a<AttachFile>       File(s) to attach to message. Multiple files and
  146.                      wildcards are allowed.
  147.  
  148. -r                   Disable adding linebreaks at column 78.
  149.                      By default MailSend adds a linebreak at column 78
  150.                      when an message text is imported, because the DOS
  151.                      client cant read lines longer than 78 chars.
  152.                      You can use -r to disable this behaviour.
  153.  
  154.  
  155. -b<Priority>         Priority for the message (1-5 or R for Recipient)
  156.  
  157.  
  158. -1                   Enable Single To Mode.
  159.                      In Single To Mode, MailSend sends one message for
  160.                      every To address ( -t ) and every CC address ( -c )
  161.                      instead of a single message with all the To's and
  162.                      CC's. This is useful if you want to send a message
  163.                      to more that one address, but each recipient should
  164.                      not see all the other recipients.
  165.  
  166.  
  167. -w                   Wait on exit for a keypress.
  168.                      Useful if you start MailSend as a second task and
  169.                      you want to see the screen output before MailSend
  170.                      exits.
  171.  
  172.  
  173. -@<ArgFile>          Read additional argument from a file (-@FILE.EXT)
  174.  
  175.                      You can create the file with your editor or
  176.                      with NotePad and write one line for every argument.
  177.                      ( see example for ARG.TXT below )
  178.  
  179.  
  180. -l                   Scans your drives for a postoffice
  181.  
  182.                      If you have no idea where your postoffice is
  183.                      located and MailSend will not find it, you can use
  184.                      this option. After completion, write down the path
  185.                      and use it the next time you send a message.
  186.  
  187.  
  188. Samples
  189. -------
  190.  
  191.  
  192.    To send mail from Admin with a password of PASSWORD to
  193.    Rick (located on Network NET and postoffice POST) and your maildrive
  194.    is M: use the following:
  195.  
  196.    MailSend -fAdmin -pPassword -dM -tNet/Post/Rick -sTestmail
  197.  
  198.  
  199.    To attach a file to the message:
  200.  
  201.    MailSend -fAdmin -pPassword -dM -tNet/Post/Rick -sTestMail -aATTACH.XLS
  202.  
  203.    Same as above with an argument file:
  204.  
  205.    MailSend -@ARG.TXT
  206.  
  207.  
  208. Sample ARG.TXT
  209. --------------
  210.  
  211.    -fAdmin
  212.    -pPassword
  213.    -dM
  214.    -tNet/Post/Rick
  215.    -sTestMail
  216.    -aATTACH.XLS
  217.    <End of file>
  218.  
  219.  
  220.  
  221. Using MAILSEND.DEF
  222. ------------------
  223.  
  224. Every time MailSend starts its looks for MAILSEND.DEF in the directory
  225. where MAILSEND.EXE resides. MAILSEND.DEF can be used to provide MailSend
  226. with default arguments. If your postoffice is always at the same
  227. drive its a good idea to use a MAILSEND.DEF to use your drive as the
  228. default.
  229.  
  230. You can create MAILSEND.DEF with your editor or with NotePad and
  231. write one line for every argument.
  232.  
  233. Here is a sample MAILSEND.DEF:
  234.  
  235.    -dM
  236.    <End of file>
  237.  
  238.  
  239.  
  240.  
  241. Resolving address
  242. -----------------
  243.  
  244. Note: Resolving an address is not available if you use MAPI (-mt)
  245.  
  246. MailSend can resolve your address to a full address. This is a real
  247. shortcut if you send a message to a user in your own network/postoffice
  248. or if you don't know your network/postoffice. WFW and Win95 users can
  249. always use this option, because there is only one postoffice.
  250.  
  251. How it works:
  252.  
  253. When MailSend detects that there is no valid address given, it will take
  254. a look inside the global address book and will try to find an address
  255. with matches your input. First it looks at every mailbox name and then
  256. at every alias name on you postoffice, and if it finds one, its uses its
  257. address.
  258.  
  259. Assume your network is called "Network" and your postoffice is
  260. "Postoffice" and you want to send to a mailbox "MillerC" with an alias
  261. of "Carl Miller".
  262.  
  263. The traditional way is to use -tNetwork/Postoffice/MillerC, which is
  264. the full address of "MillerC".
  265.  
  266. The shortcut is to use -tMillerC instead of -tNetwork/Postoffice/MillerC
  267.  
  268. MailSend now searches for a mailbox "MillerC" and resolves the address.
  269.  
  270. Another way is to use -tCarl Miller or -tCarlMiller
  271. (The space does not care when resolving addresse). In this example
  272. MailSend searches for an alias name of "CarlMiller".
  273.  
  274. If you know that there is only one alias name starting with "Carl" you
  275. can further trim it down to -tCarl and MailSend will find it.
  276.  
  277.  
  278.  
  279. Return Codes
  280. ------------
  281.  
  282. MailSend supports the following return codes (errorlevel):
  283.  
  284.    0   Message sent
  285.    1   Message not sent
  286.  
  287.  
  288.  
  289. More information
  290. ----------------
  291.  
  292. Enclosed you will find FAQ.TXT which answers frequently asked questions
  293.  
  294.  
  295.  
  296. Latest Version:
  297. ---------------
  298.  
  299. You will find the lastest version of MailSend on
  300.  
  301. ftp://ftp.dataenter.co.at        or
  302. http://www.dataenter.co.at       or
  303. CompuServe, GO PCAPP, LIB 9
  304.  
  305. Filenames are:
  306.  
  307.    MaSndDOS.ZIP   DOS   Version
  308.    MaSndW16.ZIP   Win16 Version
  309.    MaSndW32.ZIP   Win32 Version
  310.    MaSndOS2.ZIP   OS/2  Version
  311.  
  312.  
  313.  
  314. Licensing Agreement
  315. -------------------
  316.  
  317.     MailSend (c) is copyrighted 1993-1997 by DataEnter, Michael Kocum,
  318.     portions (c) Microsoft Corp.
  319.  
  320.     This product and its documentation may not, in whole or in part, be
  321.     copied, reproduced, transmitted, transcribed, stored in a retrieval
  322.     system, or translated into any other natural or computer language, in
  323.     any form or by any means whatsoever, be it electronic, mechanical,
  324.     magnetic, optical, manual or otherwise, without the prior written
  325.     consent of DataEnter.
  326.  
  327.     DataEnter makes no warranty or representation, either expressed or
  328.     implied, with respect to the product MailSend and its
  329.     documentation, their quality, perfomance, merchantability, or fitness
  330.     for a particular purpose. DataEnter reserves the right to revise the
  331.     user's guide and make changes in the content without obligation to
  332.     notify any person or organization of such a change.
  333.  
  334.     In no event will DataEnter be liable for any direct, indirect,
  335.     special, incidental or consequential damages, real or imagined,
  336.     resulting from the use or purchase of this software.
  337.     Under no circumstances shall DataEnter's liability for damages
  338.     exceed the price paid for the software license.
  339.  
  340.     Should any remedy hereunder be determined to have failed, all
  341.     limitations of liability and exclusion of damages set forth above
  342.     shall remain in full force and effect.
  343.  
  344.     The extent of the DataEnter's warranty for the software and its
  345.     documentation is limited to physical defects of the distribution media
  346.     containing the software. Contact DataEnter to obtain return
  347.     authorization for the replacement diskette within 30 days of the
  348.     original date of purchase. Any further statement made by agents,
  349.     employees, distributors or dealers of DataEnter do not constitute
  350.     warranties and are not binding. No employee of DataEnter has the
  351.     authority to modify any portion of this warranty.
  352.  
  353.     All brand and product names we refer to in the documentation are used
  354.     solely for identification purposes and may be trademarks of other
  355.     companies.
  356.  
  357.     DataEnter, (the licensor) grants the buyer (the licensee)
  358.     the right to use this copy of MailSend (the program)
  359.     on a single postoffice at a single location as long as the
  360.     licensee complies with the terms of this license. The licensor
  361.     reserves the right to terminate this license if the licensee
  362.     violates any part of the agreement.
  363.  
  364.     The licensee agrees to make copies of the program only for backup
  365.     purposes. The licensee agrees not to copy the documentation and to
  366.     take all necessary precautions to ensure that the backup copies of the
  367.     software are not distributed to or acquired by other parties.
  368.  
  369.     Microsoft Mail is a trademark of Microsoft Corp.
  370.     Windows for Workgroups is a trademark of Microsoft Corp.
  371.     Windows NT is a trademark of Microsoft Corp.
  372.     Windows Windows 95 is a trademark of Microsoft Corp.
  373.     OS/2 is a trademark of IBM Corp.
  374.  
  375. History:
  376. --------
  377.  
  378. v3.00            Released
  379. v3.01  01.03.96  Fixed a bug in parsing the command line
  380.                  Fixed online description
  381.  
  382. v3.02  96-03-27  Removed waitstate on error in DOS, Win32 and OS/2
  383.  
  384. v3.02a 96-04-08  Retry fileopen to prevent timeout when a lot of messages
  385.                  are sent
  386.                  Fixed a bug where deleting a ptr befor a waitstate in
  387.                  Win16 caused a GPF
  388.  
  389. v3.02b 96-04-12  Fixed a bug where every address was prefixed with "MS"
  390.                  in MAPI mode
  391.                  Fixed a bug causes a GPF when a empty address was given
  392.  
  393. v3.03  96-04-23  Added support for FFAPI gateways
  394.  
  395. v3.04  96-05-15  If "TEMP" enviroment variable points to an invalid
  396.                  directory MailSend uses now the directory where the EXE
  397.                  resides. If this also fails, MailSend uses the current
  398.                  directory.
  399.  
  400. v3.05  96-05-20  Fixed a bug where MailSend does not set user count.
  401.  
  402. v3.06  96-06-06  Allow processing of more than one -@
  403.                  Logon sequence optimized for Exchange Client
  404.                  Profile for Exchange can now be used in -f parameter
  405.  
  406. v3.07  96-06-19  Added display of full address. This should help Exchange
  407.                  users finding there own address
  408.  
  409.                  Fixed a bug where MailSend tries to establish a
  410.                  MAPI session in an enviroment that does not support it
  411.                  ( MailSend ignores -mt in DOS and OS/2 )
  412.  
  413. v3.08  96-08-31  Fixed a routing problem with SNADS and PROFS
  414.                  Fixed display of MCI addresses
  415.  
  416. v3.09  96-11-14  Fixed command line parsing problem
  417.  
  418. v3.10  97-01-03  Added -r switch to disable checking of linebreaks at column 78
  419.                  Added all switches on help page
  420.